MCSetClip(IM: QC)

Inside Macintosh: QuickTime Components /

Chapter 2 - Movie Controller Components / Movie Controller Components Reference

Movie Controller Functions / Managing Controller Attributes

MCSetClip
The MCSetClip function allows you to set a movie controller's clipping region. This clipping region is equivalent to the movie display clipping region supported by the Movie Toolbox.
pascal ComponentResult MCSetClip (MovieController mc, 
                                  RgnHandle theClip, 
                                  RgnHandle movieClip);
mc
Specifies the movie controller for the operation. You obtain this
identifier from the Component Manager's OpenComponent or OpenDefaultComponent function, or from the NewMovieController function (described on page 2-28).
theClip
Contains a handle to a region that defines the controller's clipping region. This clipping region affects the entire movie controller and its movie, including the controller's badge and associated controls. Set this parameter to nil to clear the controller's clipping region.
movieClip
Contains a handle to a region that defines the clipping region of the controller's movie. This clipping region affects only the movie and the badge, not the movie controller. Set this parameter to nil to clear the movie clipping region.

DESCRIPTION
Your application must dispose of the regions you supply to the MCSetClip function.

SPECIAL CONSIDERATIONS
Do not use the Movie Toolbox's SetMovieDisplayClipRgn function to modify movies that are associated with movie controllers.

RESULT CODES
Memory Manager errors

SEE ALSO
You can retrieve information about a controller's clipping information by calling the MCGetClip function, which is described in the next section.